home *** CD-ROM | disk | FTP | other *** search
/ Shareware Games Galore! / Shareware Games Galore!.iso / arcade / jrcs11 / jrcsim11.doc < prev    next >
Encoding:
Text File  |  1994-07-04  |  14.3 KB  |  406 lines
  1.  
  2.  
  3.  
  4.                                        *
  5.  
  6.                                Jesper RC Simulator
  7.                                   Version 1.1
  8.  
  9.                                    June 1994
  10.  
  11.                                  Jesper Hansen
  12.  
  13.                                     Sweden
  14.  
  15.                                   Compuserve
  16.                                   100335,3165
  17.  
  18.                                        *
  19.  
  20.  
  21.  
  22.         Hi, all you RC-folks out there, and everyone else reading this too,
  23.         for that matter.
  24.  
  25.  
  26.         Contents :
  27.  
  28.                 Disclaimer
  29.                 What's This
  30.                 Archive Files
  31.                 Installation & Startup
  32.                 Keyboard Controls
  33.                 Information Bars
  34.                 Configuration File
  35.                 Polygon Data Files
  36.                 Technical Info
  37.                 Future Improvements
  38.                 Version History
  39.                 Comments & Suggestions
  40.                 Acknowledgements
  41.                 References
  42.                 The Author
  43.  
  44.  
  45. Disclaimer
  46. ----------
  47.  
  48.         I assume absolutely no responsibility whatsoever for any effect that
  49.         this program or any of its files might have on your computer, yourself
  50.         or others.
  51.         No warranty is provided nor implied.
  52.         So if you machine thinks it's an awful program, walks off and drop
  53.         itself down the drain, I'm sorry, but don't call me.
  54.  
  55.  
  56.  
  57.  
  58. What's This ?
  59. -------------
  60.  
  61.         Nothing. Really. You can just delete everything or otherwise throw it
  62.         away. BUT, you just might miss something.
  63.  
  64.         JRCSIM is a simple RC flight trainer or simulation program.
  65.         This version 1.1 is still a VERY raw version.
  66.  
  67.         JRCSIM allows you to train simple flight. Landings are not realistic
  68.         but might be useful. The most important thing to train, are flying
  69.         towards yourself.
  70.         A mid-wing trainer is available for aeroplane training.
  71.  
  72.         Version 1.1 includes a very simple helicopter flight model. I have
  73.         not fixed the heli poygon data, so you will have to use the usual
  74.         airplane as well as your imagination. The flight model is simply the
  75.         aircraft model with lift and drag removed and thrust directed up
  76.         instead of forward. With large Pitch- and Roll-rates however it works
  77.         reasonably, I think.
  78.  
  79.  
  80.                         ---------------------------------------
  81.  
  82.         JRCSIM is absolutely FREEWARE. Version 17.41 might someday be share-
  83.         ware, but for now, I'll rather let your suggestions shape the program.
  84.         And, I'm not as obligated to release new versions continously, as if
  85.         you were paying for it.
  86.  
  87.         HOWEVER, if you insist of giving your money away (did you hear that
  88.         Bill G. ?), you are welcome to send a donation to the address below.
  89.  
  90.         Or just send a postcard.
  91.  
  92.         If you would like the source code, let me know. If enough interest
  93.         arises, I could include it in the archive for the next version.
  94.  
  95.         Spread JRCSIM around, it's free for you to copy it to friends or to
  96.         upload it to BBS's.
  97.  
  98.  
  99.  
  100. Archive Files
  101. -------------
  102.  
  103.         JRCSIM10.ZIP should contain the following files :
  104.  
  105.         JRCSIM10.EXE            - sim executable
  106.         JRCSIM10.DOC            - you already know what that is, don't you ?
  107.         TRAINER.FM              - simple trainer flight model
  108.         HELI.FM                 - bogus helicopter flight model
  109.         TRAINER.POL             - plane polygon data
  110.         HELI.POL                - same as above
  111.         STAT*.POL               - static data
  112.         SKY.BMP                 - bitmap file for the Sky.
  113.         MOUNT.BMP               - bitmap file for the Mountains.
  114.         JRCSIM.PAL              - palette file.
  115.         WHATSNEW.*              - change information.
  116.  
  117.  
  118.         DO NOT DISTRIBUTE JRCSIM10.ZIP WITH ANY FILES ADDED OR DELETED TO IT.
  119.  
  120.  
  121.  
  122. Installation & Startup
  123. ----------------------
  124.  
  125.         Installation is easy. You have probably already done it. Simply copy
  126.         all files to your favourite hard-disk.
  127.  
  128.         Start JRCSIM by entering JRCSIM10 on the command line, optionally
  129.         followed by a flight model specification.
  130.         Example :
  131.  
  132.                 JRCSIM heli
  133.  
  134.         starts JRCSIM with the helicopter flightmodel.
  135.         If no flight model is given, JRCSIM will start with the TRAINER model.
  136.  
  137.         JRCSIM will assume that you have two joysticks at startup. This can be
  138.         overridden by using one of the following command line switches :
  139.  
  140.                 -2              - rudders only on joystick 2
  141.                 -1              - one joystick on pitch/roll axis only
  142.                 -0              - no joysticks at all
  143.  
  144.         You can also use the Thrustmaster VCS for controlling thrust.
  145.         Use the same setup as for the Comanche helicopter sim.
  146.  
  147.         To exit JRCSIM, press Escape.
  148.  
  149.  
  150.  
  151.  
  152. Keyboard Controls
  153. -----------------
  154.  
  155.                 d       - Increase Thrust
  156.                 e       - Decrease Thrust
  157.               Arrows    - Pitch and Roll
  158.      Numeric Keypad '5' - Center all controls
  159.                 z       - Yaw left
  160.                 x       - Yaw right
  161.                 +       - Zoom in
  162.                 -       - Guess what !
  163.                 y       - increase camera Y-position
  164.                 Y       - decrease camera Y-position
  165.                 i       - re-initialize flight
  166.                ESC      - exits JRCSIM.
  167.  
  168.  
  169. Information Bars
  170. ----------------
  171.  
  172.         While flying, 4 bars show some useful flight information.
  173.         Two bars are on the left :
  174.  
  175.                 Green Bar       > Altitude
  176.                 Red Bar         > Distance from center (where you are)
  177.  
  178.         On the right, two other bars show :
  179.  
  180.                 Yellow Bar      > Speed
  181.                 Magenta Bar     > Thrust
  182.  
  183.  
  184. Configuration File
  185. ------------------
  186.  
  187.         The flight model is controlled by a configuration file. The possible
  188.         entries are (the order is irrelevant) :
  189.  
  190.                 Model                   - 0-power model, 1-heli, 2-glider
  191.                 Gravity                 - earth sucking in m/s/s
  192.                 WingSpan                - span in meters. NOT ACTIVE !
  193.                 WingChordInner          - chord in meters. NOT ACTIVE !
  194.                 WingChordOuter          - chord in meters. NOT ACTIVE !
  195.                 WingArea                - wing area in square meters
  196.                 StabArea                - stabilator area in square meters
  197.                 ElevatorArea            - elevator area in square meters
  198.                 AileronArea             - ail. area in sq. meters. BOTH ail's !
  199.                 AileronDistance         - ail. dist. from center. NOT ACTIVE !
  200.                 Weight                  - model weight in kilos.
  201.                 PitchRate               - rate of Pitch. relative scalar value.
  202.                 YawRate                 - rate of Yaw. relative scalar value.
  203.                 RollRate                - rate of Roll. relative scalar value.
  204.                 FrameTime               - sim speed. relative scalar value
  205.  
  206.         See the *.FM files in the archive for examples of flight model data.
  207.  
  208.         In newer versions, some of the values will be overridden by others.
  209.         As an example :
  210.         The value of WingArea will be overridden by the combination of Wing-
  211.         span, WingChordInner and WingChordOuter when these are activated.
  212.  
  213.         In version 1.1, the lift and drag coefficients are fixed and cannot
  214.         be changed.
  215.  
  216.  
  217. Polygon Data Files
  218. ------------------
  219.  
  220.         All polygon data used in the program is stored as ASCII files.
  221.         This means that you can change the shape of the plane or you can
  222.         add or delete the static objects (they are not really static then,
  223.         are they ?).
  224.  
  225.         The program will read all STAT*.POL files it can find on startup, so
  226.         you are free to add more towers or Disneylands or whatever you like.
  227.  
  228.         Don't forget, that if you do any .POL files, I would VERY much like
  229.         to have them for inclusion in future versions.
  230.  
  231.  
  232.         The format of the .POL data files are as follows :
  233.  
  234.             number_of_vertices          - number of vertices in list
  235.             vert0[X,Y,Z]                - vertice 0
  236.             vert1[X,Y,Z]                - vertice 1
  237.              .                              .
  238.              .                              .
  239.             vertN[X,Y,Z]                - last vertice
  240.             number_of_faces             - number of faces in list
  241.             verts_in_face,facecolor     - # vertices in face, color of face
  242.             verticelist....             - list of verticenumbers
  243.             verts_in_face,facecolor
  244.             verticelist....
  245.                .
  246.                .
  247.                .
  248.             verts_in_face,facecolor
  249.             verticelist....
  250.             startcoordinates[X,Y,Z]     - placement of object at startup
  251.             scale[X,Y,Z]                - adjustable scaling of the polygon
  252.  
  253.  
  254.         See the *.POL files in the archive for examples of polygon data.
  255.  
  256.         Note that verticelist should list vertices in counter-clockwise order
  257.         when viewed from the outside !
  258.  
  259.  
  260. Technical Information
  261. ---------------------
  262.  
  263.         So all you technojocks out there, here are some info on JRCSIM.
  264.  
  265.         JRCSIM is written mostly in C with a few assembler routines.
  266.         It's only 2241 lines in C and 1283 in assembler of which 860 lines
  267.         the code for fixed point vector and matrix arithmetic.
  268.  
  269.         The graphics mode is 320*200*256 although only a few colors are used.
  270.  
  271.         The flight model flow is like this :
  272.  
  273.                 Determine current velocity
  274.                 Calculate Dynamic Pressure
  275.                 Calculate Lift and Drag based on this and Coefficients
  276.                 Get Pitch Control info
  277.                 Calculate Pitch moment and Angle of attack
  278.                 Get Roll Control info
  279.                 Calculate Roll moment
  280.                 Get Yaw Control info
  281.                 Put directly as Yaw moment
  282.                 Rotate moments to planes current attitude
  283.                 Set changes to attitude from these values
  284.                 Put Thrust,Lift,Drag in vectors
  285.                 Rotate this to planes current attitude
  286.                 Add Weight to this
  287.                 Calculate acceleration from this info
  288.                 Set changes to movement from these values
  289.  
  290.  
  291.  
  292. Future Improvements
  293. -------------------
  294.         Ver. 1.0
  295.         --------
  296.         I have a lot of ideas for future versions. Some of them could have
  297.         been put into this first version, but I would rather release a simple
  298.         version and listen to the public opinion.
  299.         Some of the planned ideas :
  300.  
  301.         - Speed improvement             - has to remove some float stuff.
  302.         - Higher screen resolution      - easy really, will it be fast enough ?
  303.         - Better control input          - Mouse/Keyboard/Joysticks e.t.c.
  304.         - Better Crash Detection        - Only checks vertical velocity now.
  305.         - Sound (SB & compat)           - ready, has to be ported to C.
  306.         - Textured planes and statics.  - has been removed while developing
  307.                                           this version. Just has to be put
  308.                                           back in.
  309.         - Better flightmodel.           - Lift and Drag Coefficients. Center
  310.                                           of gravity. Flaps, spoilers, slats,
  311.                                           retracts. You name it.
  312.         - Dual player mode.             - Could be fun.
  313.         - Helicopter Flightmodel        - has to improve the current one.
  314.         - Glider Flightmodel            - Hmmm. A Rubber band simulator ?
  315.  
  316.  
  317.  
  318.  
  319. Version History
  320. ---------------
  321.  
  322.         Date          Version         Comments
  323.         ----------    --------        -------------------------------------
  324.         June 1994       1.0             First released version
  325.         July 1994       1.1             Backgrounds added,scaling,hidden faces
  326.                                         routine improved.
  327.  
  328.  
  329. Comments & Suggestions
  330. ----------------------
  331.  
  332.         Unless you comment this program and suggest changes and improvements,
  333.         the next version of this program will not be much different from this
  334.         and it will NOT contain any of your ideas ( unless by accident :-) ).
  335.  
  336.         Even criticism is read before deleted, especially if constructive !
  337.  
  338.         So log on to Compuserve and send your ideas to :
  339.  
  340.                 100335,3165     Jesper Hansen
  341.  
  342.         either as e-mail or in MODELNET.
  343.  
  344.         Snail mail at :
  345.  
  346.                 Jesper Hansen
  347.                 Takpannevagen 66
  348.                 186 36 Vallentuna
  349.                 Sweden
  350.  
  351.  
  352. Acknowledgements
  353. ----------------
  354.  
  355.         Thanks to Michael Abrash for his series of Graphics Programming
  356.         articles in Dr. Dobbs Journal. Some of the modules from his XSHARP
  357.         archive are used in this program.
  358.  
  359.  
  360.  
  361. References
  362. ----------
  363.  
  364.         Dr. Dobbs Journal                       - Graphics Programming
  365.         Several issues
  366.  
  367.         Model Aircraft Aerodynamics             - Lots of interesting stuff
  368.         Martin Simons
  369.         Argus Books / Motorbooks International
  370.         ISBN 0-85242-915-0
  371.  
  372.         Gieck's Technical Formulae              - A lot of useful formulaes
  373.         Kurt Gieck
  374.         Gieck Verlag
  375.         ISBN ?
  376.  
  377.         Interactive Computer Graphics           - Vector & Matrix stuff
  378.         Peter Burger/Duncan Gillies
  379.         Addison-Wesley
  380.         ISBN 0-201-17439-1
  381.  
  382.         Progr. Guide to the EGA & VGA Cards     - VGA programming
  383.         Richard F. Ferraro
  384.         Addison-Wesley
  385.         ISBN 0-201-57025-4
  386.  
  387.         PCGPE.ZIP                               - lots of programming info
  388.         GAMERS Forum on Compuserve
  389.  
  390.  
  391. The Author
  392. ----------
  393.  
  394.         That's me !
  395.         I'm a 35 year old data consultant, working mainly with embedded systems.
  396.         Currently writing a realtime OS for a major printer manufacturer.
  397.         I've been flying model aircraft for several years, tried helicopters
  398.         without much success. Are a fanatic of flight simulators.
  399.  
  400.  
  401.         Happy flying !
  402.  
  403.  
  404.  
  405.  
  406.